home *** CD-ROM | disk | FTP | other *** search
/ Light ROM 1 / LIGHT-ROM 1 (Amiga Library Services)(1994).iso / ffdisks / d910.lha / IEv4Demo / IE.Doc < prev    next >
Text File  |  1993-08-28  |  34KB  |  775 lines
  1.                       IE - The Complete Icon Editor     by Peter Kiem
  2.                                                            15 Penfold St
  3.                                                            Hillcrest
  4.                                                            QLD 4118
  5.                                                            Australia
  6.                                                            (07) 800-8459
  7.  
  8.  
  9.  
  10. ABOUT IE
  11. --------
  12.     IE is a shareware program which allows the creation and editing of icons
  13. on the Amiga personal computer.  Using IE you can make icons much larger and
  14. easier than using the supplied icon editor on your system disks.
  15.  
  16.     You do not have to mention in your documentation that the icons were
  17. created with IE, but it would be nice for you to include a message like:
  18.  
  19.     Icons created with IE - The Complete Icon Editor
  20.  
  21.  
  22.  
  23. DEMONSTRATION VERSION CHANGES
  24. -----------------------------
  25.     The demonstration version of IE is fully functional so you can test all
  26. the functions of IE and determine if you wish to register or not.  To
  27. encourage you to register IE, the demonstration version also has a few
  28. changes:
  29.  
  30.     -   After starting the demonstration version of IE two requesters will
  31.     be displayed giving information about the demonstration version and
  32.     about obtaining a registered copy of IE.  These requesters will
  33.     disappear after 30 seconds each and you can then continue with IE.
  34.  
  35.     -   The demonstration version will also exit after any "save" operation
  36.     is performed.  This is done so you can see the effects of changing an
  37.     icon with IE rather than totally disabling the save functions as some
  38.     demonstration programs do.
  39.  
  40.     When you register your copy of IE you receive a registration number and
  41. a fully operational copy of IE with your name coded into the title bar as
  42. proof of your registration.  You will also be entitled to upgrades (for a
  43. small fee) if I create new versions of IE.
  44.  
  45.     I am not making a living from writing IE so I have not charged as much
  46. as I could had I marketed it commercially.  A fully registered version of IE
  47. will only cost you AUD$20.  Please respect the amount of time and effort I
  48. have put into IE and consider the small fee asked if you continue to use this
  49. program.
  50.  
  51.     Updates are available to registered users by returning your ORIGINAL disk
  52. to me at the above address along with a postage and handling charge of:
  53.  
  54.     Australia      AUD$ 5
  55.     Overseas       AUD$10
  56.  
  57.  
  58.  
  59. DISTRIBUTION OF IE
  60. ------------------
  61.     You can freely distribute the DEMONSTRATION version of IE as long as the
  62. following is observed:
  63.  
  64.     -   The program and documentation must be distributed together and are
  65.     not modified in any way.  The only exception is that the program and
  66.     documentation may be compressed into an archive for uploading to
  67.     Bulletin Boards or for other electronic transmission.
  68.  
  69.     -   The program is not used commercially or included in a commercial
  70.     package for profit unless written authorisation from me is obtained
  71.     first.  The demonstration version of IE may be freely included on public
  72.     domain library disks or compilation disks provided only a small fee is
  73.     charged for the service.
  74.  
  75.     A REGISTERED version must NEVER be distributed in ANY way.
  76.     (after all, you paid for it - so should others).
  77.  
  78.  
  79.  
  80. IE SYSTEM REQUIREMENTS
  81. ----------------------
  82.     IE requires Workbench 2.04 or later.  The functions used for IEv4.0 are
  83. not available in Workbench 1.3 or earlier.  If you require a version of IE
  84. for Workbench 1.3 or earlier then you can obtain IEv3.0 from me at the above
  85. address.  A demonstration version of IEv3.0 is on Fish Disk 621.
  86.     IE also requires "asl.library" and "diskfont.library" to be present in
  87. your LIBS: directory.  Unless you have removed libraries from your boot disk
  88. you will not have to worry about this.
  89.     IE will now quite happily run in 1/2 Meg memory using the default image
  90. size, screen resolution and number of colours unlike IEv3.0 which required 2
  91. Meg of memory.
  92.  
  93.  
  94.  
  95. WHAT ARE ICONS?
  96. ---------------
  97.    Icons are the pictures on Workbench that allow you to start a program,
  98. select a document or examine the contents of a disk.  These icons can also
  99. have a second picture which is displayed when the icon is selected giving
  100. the appearance of motion etc.
  101.  
  102.     Icons can also pass information to the tool called through the use of
  103. "Tool Types".  IE will also allow you to edit these and more.
  104.  
  105.     There are five different types of icons representing the different types
  106. of files on the Amiga:
  107.  
  108.     DISK ICON - To represent disks or harddrive partitions.  (NOTE: A disk
  109.     icon will only be displayed when it is named "disk.info" and is in the
  110.     top directory of a disk or HardDrive partition).
  111.  
  112.     DRAWER ICON - To represent a drawer (directory) on a disk.
  113.  
  114.     TRASHCAN ICON - To represent the special drawer known as the Trashcan
  115.     which is used for deleting files.
  116.  
  117.     TOOL ICON - To represent an executable program.
  118.  
  119.     PROJECT ICON - To represent a document, drawing, picture etc that is
  120.     passed to the tool for being edited.
  121.  
  122.  
  123.  
  124. INSTALLING IE
  125. -------------
  126.     IE can be simply installed on your system by dragging the IE icon into
  127. window on your disk that you wish to place IE into.  No special assigns or
  128. "hidden" files are used by IE.
  129.     It is recommended however, that the entire IE drawer is copied so you can
  130. always find the documentation files.
  131.  
  132.  
  133.  
  134. STARTING IE
  135. -----------
  136.     The simplest method of starting IE is by double-clicking on the IE icon
  137. from Workbench.  This will start IE ready to create an icon.
  138.  
  139.     Another method of starting IE from Workbench is to single-click on a
  140. project icon, hold down the "shift" key and double-click on the IE icon.
  141. This will start IE and automatically load the project icon for editing.
  142.  
  143.     IE can also be started from the CLI by typing "IE" optionally followed
  144. by the name of the icon to load.  This icon can be of any type and the
  145. ".info" suffix needed not be included in the name.
  146.  
  147.     The tooltypes and CLI parameters that IE accepts are listed at the end of
  148. this document.  These allow you to select the screen resolution and interlace
  149. settings for the IE screen, the number of colours the icon should contain and
  150. to increase the maximum image size that IE works with.
  151.  
  152.  
  153.  
  154. THE ICON DISPLAY WINDOW
  155. -----------------------
  156.     On the main IE window there is a large square region on the left hand
  157. side.  In this window the icon being edited is displayed 8 times normal
  158. size.  This magnification can be changed by moving the slider gadget above
  159. the display window.  This slider does not actually change the size of the
  160. icon but how large each pixel is displayed in the edit window.
  161.  
  162.     To see different parts of the icon simply click, or slide, the
  163. horizontal and vertical scroll bars next to the display window.  This allows
  164. you to move quickly around the image.
  165.  
  166.     Alternatively you can click on the arrow gadgets next to the scroll bars
  167. to shift the display one pixel at a time in the direction of the arrow.
  168. Holding down the left mouse button on one of these arrow gadgets will
  169. continuous scroll the image a pixel at a time in that direction.
  170.  
  171.     The "H" gadget in the top-right corner of the display window returns the
  172. horizontal and vertical scroll bars quickly to the "Home" position (that is,
  173. with the top-left corner of the icon being displayed).
  174.  
  175.     Underneath the display window are the current coordinates of the pointer
  176. within the icon and the name of the icon currently being edited.
  177.  
  178.  
  179.  
  180. SELECTING WHICH ICON IMAGE TO EDIT/DISPLAY
  181. ------------------------------------------
  182.     Icons can be made of one or two images.  The first image is the image
  183. displayed on the Workbench screen before any selection is made and is called
  184. the "Normal Image".  The second (optional) image is displayed when the icon
  185. is selected and is called the "Selected Image".
  186.  
  187.     To the right of the "H" gadget is the Image Select gadget.  This gadget
  188. allows you to select which image you are displaying/editing.  Click on this
  189. gadget to switch between the two images.
  190.  
  191.  
  192.  
  193. THE UNDO EDIT GADGET
  194. --------------------
  195.     Just underneath the Select Image gadget is the Undo Edit gadget. As the
  196. name suggests, this gadget will "undo" the last editing operation.  This
  197. enables you to reverse the effects where the edit you performed was
  198. incorrect (e.g. If your Flood-Fill leaked and destroyed your image, then
  199. click on the Undo Edit gadget and the image will be restored to before the
  200. Flood-Fill).
  201.  
  202.     The Undo Edit gadget will only undo the changes of the LAST edit and not
  203. previous ones.  Certain operations likewise will not be able to be undone
  204. and the gadget will be disabled to inform you of this fact.
  205.  
  206.  
  207.  
  208. SELECTING A DRAWING COLOUR
  209. --------------------------
  210.     To select a colour to draw in, click on one of the colour gadgets down
  211. the right-hand side of the main IE window.  The brush pointer's tip will
  212. change to the selected colour to remind which colour you are using.
  213.  
  214.     AGA users (A1200/A4000) take note:  If you are editing an icon with more
  215. than 16 colours then one of the colours in the palette will change when you
  216. select a colour to use.  This is because non-AGA machines use colour register
  217. 16 to 19 for the mouse pointer.  Apparently the AGA machines use the full 256
  218. registers and I don't as yet have the Workbench3 docs to fix this bug.  This
  219. shouldn't affect your icon at all it only affects the IE display colours.
  220.  
  221.  
  222.  
  223. CHANGING THE ICON'S IMAGE
  224. -------------------------
  225.     To change the colour of a pixel in the icon's image simply position the
  226. pointer in the display window over the pixel you want to change and click
  227. the left mouse button.  The pixel will then change to the currently selected
  228. colour as denoted by the pointer's brush tip.
  229.  
  230.     By holding down the left mouse button and moving the pointer within the
  231. display window the pointer will continuously draw into the image changing
  232. the pixels moved over into the currently selected colour.
  233.  
  234.  
  235.  
  236. THE EDIT MODE GADGETS
  237. ---------------------
  238.     These gadgets allow you to select what type of drawing action is being
  239. performed.  The selections are described below:
  240.  
  241.     DRAW
  242.       Freehand drawing as described in the "CHANGING THE ICON'S IMAGE"
  243.     section above.
  244.  
  245.     FLOOD FILL
  246.       A mouse click within the display window will initiate a "flood" paint.
  247.     The pixel under the pointer is changed to the currently selected colour
  248.     and this continues for all pixels of the same colour "connected" to the
  249.     selected one.  Only horizontal and vertical "connections" are checked for
  250.     flood fill, diagonals are ignored.  This can be used to quickly fill in
  251.     an area instead of painting all of it by hand.
  252.       Remember that the Undo-Edit gadget will restore your image if the flood
  253.     fill "leaks" and destroys your image but it must be done straight away.
  254.  
  255.     WRITE TEXT
  256.       A mouse click within the display window will initiate a text write.  A
  257.     requester is displayed asking for the text to write into the image.  The
  258.     string gadget is automatically activated for you so you can just start
  259.     typing and press the return key when finished.
  260.       If you wish to use a different font, style or colour than the default
  261.     (Topaz/8 - Text Only - White Text) then you can click on the Text Options
  262.     gadget which will then bring up a Font Requester.  This requester allows
  263.     you to scroll through the list of available fonts, select one and apply
  264.     any combination of the style changes bold, italic and underline.  The
  265.     highlighted font name represents the current font.  A sample text in the
  266.     selected font and styles can be seen in the requester to enable you to
  267.     make your decision before leaving the requester.  The selected font and
  268.     style then becomes the default for further text writes.
  269.       The Text colour gadget selects what colour to draw the text in.  The
  270.     Field colour gadget selects what colour to draw the background in.  The
  271.     Mode gadget allows you to select the text drawing mode as detailed below:
  272.         Text Only  - Draw the text but do not disturb the background.
  273.         Text+Field - Draw the text but use a coloured rectangle as a
  274.                      background.
  275.         Complement - Draw the text without disturbing the background.  The
  276.                      selected colours are ignored and the text is written
  277.                      into the image using colours that depend on the
  278.                      background colours it is writing over.
  279.  
  280.  
  281.  
  282. THE MOVE IMAGE ARROW GADGETS
  283. ----------------------------
  284.     Below the Edit Mode gadgets are the Move Image Arrow gadgets.  These
  285. gadgets move the whole icon image in the direction of the gadget.  If you
  286. move the image outside of the boundaries then the image will be trimmed to
  287. fit.
  288.     These are not to be confused with the arrow gadgets next to the scroll
  289. bars as those gadgets are only for fine-tuning the scroll bars.
  290.  
  291.     These gadgets are most useful when you wish to create extra room on top
  292. of, or to the left of, your image in order to do more drawing.  They can
  293. also be used to eliminate "blank" space to the left of your image.
  294.  
  295.     IE will automatically strip the image to the smallest possible size when
  296. saving the icon so it may be faster to save the icon temporarily and reload
  297. it and only use these gadgets to remove the "blank" space that IE could not
  298. remove automatically.
  299.  
  300.  
  301.  
  302. The "PROJECT/NEW" menu item (Right-Amiga N)
  303. -------------------------------------------
  304.     This menu item resets IE to it's defaults for creating a new icon.  It
  305. clears the data in both images and resets the InfoEdit window parameters.
  306.  
  307.  
  308.  
  309. The "PROJECT/LOAD" menu item (Right-Amiga L)
  310. --------------------------------------------
  311.     This menu item will display the file requester to allow you to select
  312. which icon you wish to load.  See the section on the File Requester for
  313. details.
  314.  
  315.  
  316.  
  317. The "PROJECT/LOAD DEFAULT" menu item
  318. ------------------------------------
  319.     The sub-menus of this menu item allow you to select which default icon
  320. you wish to load.
  321.  
  322.     Default icons are used by Workbench to display icons for files that don't
  323. have icons already defined for them.  Workbench has the five icon types
  324. already defined but these defaults can be changed by supplying a new icon as
  325. the default.
  326.  
  327.  
  328.  
  329. The "PROJECT/SAVE" menu item (Right-Amiga S)
  330. --------------------------------------------
  331.     This menu item will save the current icon, or if you haven't selected
  332. an icon name it will display the file requester for you to select one.  See
  333. the section on the File Requester for details.
  334.  
  335.     IE will automatically strip the imagery you designed for the icon to the
  336. smallest possible size, eliminating as much "blank" space as possible,
  337. before saving.
  338.  
  339.  
  340.  
  341. The "PROJECT/SAVE AS" menu item
  342. -------------------------------
  343.     This menu item will display the file requester to allow you to select a
  344. name to save the icon under.  See the section on the File Requester for
  345. details.
  346.  
  347.  
  348.  
  349. The "PROJECT/SAVE AS DEFAULT" menu item
  350. ---------------------------------------
  351.     This menu option will save the current icon to be used as the Workbench
  352. default icon for that type.  The type is determined by the Icon Type
  353. selection in the Edit Info window described later.  Basically you load a
  354. default icon, change the imagery and parameters, and then save as default so
  355. that icon will be used by Workbench in the future.
  356.  
  357.     NOTE:  This menu option will require the icon be saved to your Workbench
  358. disk and will not work if the disk is write-protected.  Also default disk
  359. icons may not take effect until after a system reboot.
  360.  
  361.  
  362.  
  363. The "PROJECT/SAVE & QUIT" menu item (Right-Amiga F)
  364. ---------------------------------------------------
  365.     This menu item will save the current icon, or if you haven't selected
  366. an icon name it will display the file requester for you to select one.  See
  367. the section on the File Requester for details.
  368.  
  369.     After saving the icon IE will then automatically quit.  It is a shortcut
  370. to using the Right-Amiga S and Right-Amiga Q menu items.
  371.  
  372.  
  373.  
  374. The "PROJECT/ABOUT" menu item (Right-Amiga A)
  375. ---------------------------------------------
  376.     This menu item will display information about the program and show you
  377. where you can contact the author.  Press the "OK" gadget when finished
  378. reading each requester.
  379.  
  380.  
  381.  
  382. The "PROJECT/QUIT" menu item (Right-Amiga Q)
  383. --------------------------------------------
  384.     This menu item allows you to quit IE (what else?).
  385.  
  386.  
  387.  
  388. The "ICON/EDIT INFO" menu item (Right-Amiga E)
  389. ----------------------------------------------
  390.     This menu item displays the icon information editing window.  This
  391. window allows you to change the various "non-graphical" options of icons.
  392. Click in the close gadget at the top left when finished.  The options are
  393. summarised below:
  394.  
  395.     ICON TYPE - Simply select the gadget corresponding to type of icon you
  396.     wish to create (DISK, DRAWER, TOOL, PROJECT, TRASHCAN).
  397.  
  398.     HIGHLIGHTING - Select which type of highlighting the icon should have
  399.     when it is selected from Workbench.  COMPLEMENT is to reverse all the
  400.     icon colours within it's select box.  BACKFILL is to reverse all the
  401.     icon colours but only in the image not the background.  ALT RENDER is
  402.     to use the second image (Select Image).
  403.  
  404.     HORIZONTAL POSITION - Select the AUTOMATIC gadget if you wish Workbench
  405.     to automatically try to find a place to fit the icon in.  If the
  406.     AUTOMATIC gadget is turned off then the number in the string gadget
  407.     specifies the exact horizontal placement of the icon.  This can be a
  408.     negative number if the window that the icon is displayed in has been
  409.     scrolled to the left.
  410.  
  411.     VERTICAL POSITION - Same functionality as the Horizontal Position gadgets
  412.     except it is for controlling the vertical placement.  This can also be a
  413.     negative number if the window that the icon is displayed in has been
  414.     scrolled upwards.
  415.  
  416.     DEFAULT TOOL - Type the name of the tool (executable program) which this
  417.     icon is associated with.  The effect of double clicking on this icon
  418.     will be the tool is started and the file associated with this icon will
  419.     be passed to the tool.  The file associated with this icon will only be
  420.     passed to the tool if the tool is set up to receive parameters from
  421.     Workbench otherwise the tool will start as if you selected it directly.
  422.     This gadget will only work with DISK or PROJECT icons.  DISK icons
  423.     should specify a disk copy program for their default tool.
  424.  
  425.     TOOL TYPES - Up to 40 tool types can be specified in this area with the
  426.     scrolling controlled by the scroll bar and arrow gadgets.  Tool Types
  427.     are parameters which are passed to the tool such as "PRINTER=LPT".  The
  428.     tool must be written to accept Tool Types and the tool documentation
  429.     should be able to inform you of the format to use.  Simply click the left
  430.     mouse button over the tooltype line you wish to change and it will be
  431.     copied into the string gadget underneath allowing you to modify it.  To
  432.     add a new tooltype, select a blank line for changing.
  433.  
  434.     OPENED WINDOW - These gadgets enable you to specify the position and size
  435.     of the window which is displayed when the DISK, DRAWER or GARBAGE icon is
  436.     selected.
  437.  
  438.     NAME OFFSET - This enables you to specify a +/- value with which to
  439.     offset the vertical positioning of the icon name.  By specifying a
  440.     positive value the name is moved downwards.  The more usual use is to
  441.     specify a negative value which moves the name upwards.  This can be
  442.     used to centre the icon name within the image of the icon.  NOTE that
  443.     if the name is moved into the icon image only the image portion ABOVE
  444.     the name can be selected with the mouse.
  445.  
  446.     STACK SIZE - This enables you to specify the stack size for the tool
  447.     which is started by the TOOL or PROJECT icon.  A stack size of 0 means
  448.     to use the default stack size (around 4000 bytes), otherwise the stack
  449.     size you specify will be used.
  450.  
  451.     Workbench 2.04 and later has the ability to detect when an icon has been
  452. changed and the change will normally take effect immediately after saving.
  453. The only exception is that when the Opened Window parameters are changed the
  454. icon has to be reloaded by closing the window that contains the icon and
  455. reopening it.  If the icon was a disk icon then you will have to close all
  456. windows from that disk, remove the disk and reinsert the disk.
  457.  
  458.  
  459.  
  460. The "ICON/PREVIEW" menu item (Right-Amiga P)
  461. --------------------------------------------
  462.     This menu item displays the icon preview window.  This window displays
  463. as much of the icon image as possible with no magnification to give you some
  464. idea as to how it will be displayed on Workbench.
  465.  
  466.     Clicking the left mouse button in this window will toggle the display
  467. between the Normal image and the Selected image.  NOTE - The preview window
  468. will only display alternate pictures, the Complement and Backfill select
  469. options cannot be displayed in the preview window.
  470.  
  471.     Clicking the right mouse button will close the window.  The window can
  472. also be closed by the close gadget in the top left of the window.
  473.  
  474.  
  475.  
  476. The "ICON/RECOLOUR" menu item (Right-Amiga R)
  477. ---------------------------------------------
  478.     This menu item will cause second and third colours (usually black and
  479. white) in the icon to be reversed in both icon images.  This is a shortcut to
  480. using the "ICON/SWAP COLOURS" menu item for each image and is provided
  481. especially for changing icons that were created using Workbench 1.3 or
  482. earlier for Workbench 2.04+ usage.
  483.  
  484.  
  485.  
  486. The "ICON/SWAP COLOURS" menu item (Right-Amiga W)
  487. -------------------------------------------------
  488.     This menu item will display a requester where you can choose two
  489. colours to be reversed in the CURRENT image being edited (e.g. you can swap
  490. black with white).
  491.  
  492.  
  493. The "IMAGE/COPY" menu item
  494. --------------------------
  495.     The sub-menus of this menu item allow you to select an image copy
  496. function to use on the loaded icon images.  Using these sub-menus allow you
  497. to duplicate an image into the other icon image or even swap the images
  498. around.
  499.  
  500.  
  501.  
  502. The "IMAGE/SCALE" menu item
  503. ---------------------------
  504.     The sub-menus of this menu item allow to increase or decrease the current
  505. icon image.  This can be used for loading a picture and then shrinking it to
  506. make an icon to represent the picture.  Naturally, decreasing an image will
  507. lose some of the finer details of the image.
  508.  
  509.  
  510.  
  511. The "IMPORT/EXPORT /OUTPUT C CODE" menu item (Right-Amiga C)
  512. ------------------------------------------------------------
  513.     This menu item will display the file requester to allow you to select
  514. a filename to write the C language code for the icon.  See the section on
  515. the File Requester for details.  One use of this is for your programs to
  516. generate their own icons.
  517.  
  518.     The following code example shows how to write an icon file.  This
  519. assumes you generated the C Code to a file called "c-code" and are
  520. generating the icon "test.info":
  521.  
  522.         #include <exec/types.h>
  523.         #include <intuition/intuition.h>
  524.         #include <workbench/workbench.h>
  525.  
  526.         #include <functions.h>
  527.         #include "c-code";  /*ALTERNATIVELY COPY THE CODE HERE FIRST*/
  528.         extern struct IconBase *IconBase;
  529.  
  530.         void main()
  531.  
  532.         {
  533.           IconBase = (struct IconBase *) OpenLibrary("icon.library", 0);
  534.           PutDiskObject("test", &Icon);
  535.           CloseLibrary(IconBase);
  536.           exit();
  537.         }
  538.  
  539.     Another use for the generated C code is for creating gadgets for your
  540. programs.  You can create the gadget image using IE, or load in an IFF
  541. image into IE, and write the C code to a file.  The image data and image
  542. structure generated can then be copied into your program as the data for the
  543. gadget.
  544.  
  545.  
  546.  
  547. The "IMPORT/EXPORT /IMPORT IFF" menu item (Right-Amiga I)
  548. ---------------------------------------------------------
  549.     This menu item displays the file requester to allow you to choose an
  550. IFF picture file to load into the CURRENT image being edited.  This allows
  551. you to use pictures (generated by packages such as DPaint) in your icon
  552. images.
  553.     If importing an IFF file ensure that your icon has at least the same
  554. number of colours as the IFF image or some detail will be lost.
  555.  
  556.  
  557.  
  558. The "IMPORT/EXPORT /EXPORT IFF" menu item (Right-Amiga X)
  559. ---------------------------------------------------------
  560.     This menu item displays the file requester to allow you to choose the
  561. name of the IFF picture to be created from the CURRENT image being edited.
  562. This allows you to export your image to packages with more sophisicated
  563. editing features (such as DPaint) to edit your image and then later import
  564. the edited image back into your icon image.
  565.  
  566.  
  567.  
  568. The "IMPORT/EXPORT /IMPORT FROM ICON" menu items
  569. ------------------------------------------------
  570.     These menu items allow you to grab images directly from other icons.
  571.  
  572.     "NON-SELECT IMAGE" (Right-Amiga 1) allows you to load the Non-Select
  573.     image of an icon into the CURRENT image being edited.
  574.  
  575.     "SELECT IMAGE" (Right-Amiga 2) allows you to load the Select image of
  576.     an icon (if there is one) into the CURRENT image being edited.
  577.  
  578.     "BOTH IMAGES" (Right-Amiga 3) is a shortcut that allows you to load
  579.     both images from an icon into the icon you are currently editing.
  580.  
  581.  
  582.  
  583. FILE REQUESTER
  584. --------------
  585.     IE utilitises the standard file requester provided by Workbench 2.04
  586. whenever a filename is needed for various activities.  The parts of the
  587. file requester are detailed below:
  588.  
  589.     PATTERN GADGET - This gadget allows you to specify a mask which hides
  590.     files that you are not interested in.  For example, the load function
  591.     will only display icon files and directories so you don't accidently
  592.     select a file which isn't an icon.  You may wish to clear the contents of
  593.     this gadget for two reasons:
  594.       Saving an icon - By displaying all files you can select the filename of
  595.                        the program that you wish to attach the icon to.  This
  596.                        will save you typing in the program name!
  597.       Speed          - The Workbench 2.04 file requester can be slow to read
  598.                        the filenames off the disk if pattern matching is
  599.                        being used.  The file requester has less work to do if
  600.                        there is no pattern matching and hence will be faster.
  601.  
  602.     DRAWER STRING GADGET - This gadget is to display the current drawer of
  603.     which the file requester is displaying the names of files in.  You may
  604.     type a new drawer name in here and press return to quickly move to
  605.     another drawer.
  606.  
  607.     FILENAME GADGETS - These display the names of the files in the current
  608.     drawer.  The highlighted gadgets represent drawers and the rest are
  609.     ordinary files.  To select a new drawer to examine just click on the
  610.     drawer name with the left mouse button.  Selecting a filename by clicking
  611.     the left mouse button on the required file will copy the filename into
  612.     the filename string gadget.  Selecting the filename again will act like
  613.     the OK gadget has been pressed and accept the filename as final.
  614.  
  615.     FILENAME STRING GADGET - This gadget displays what the current file is.
  616.     You may type a filename directly in here to quickly select a file or to
  617.     specify the name of a new file.  This gadget is always active and at
  618.     any time you can just start typing in the filename and press return
  619.     when finished.
  620.  
  621.     PARENT GADGET - This gadget will change the current drawer to it's
  622.     parent drawer (that is, the drawer that contains the current drawer).
  623.     Selecting this gadget when at the top most drawer of a disk will have
  624.     no effect.
  625.  
  626.     VOLUMES GADGET - This gadget will cause the file requester to display the
  627.     list of volumes instead of files.  The non-highlighted gadgets represent
  628.     disks or harddrive partitions available.  The highlighted gadgets
  629.     represent logical volumes created by the use of "assign" statements.
  630.     Selecting one of these gadgets will set the current drawer to the
  631.     assigned logical volume or disk.
  632.  
  633.  
  634.  
  635. IE'S AUTOSAVE FUNCTION
  636. ----------------------
  637.     To try to prevent you from losing your work (from power loss, system
  638. failure, etc)  IE will automatically try to save your icon into the file
  639. "IE.AutoSave.info" five minutes after a change has been made to an icon
  640. without the icon being saved.  This file will be automatically deleted if IE
  641. is exited with the "PROJECT/QUIT" or "PROJECT/SAVE & QUIT" menu items.
  642.  
  643.     If IE finds the autosave file present when it starts it will ask if you
  644. want to reload the icon from the autosave file restoring your work.
  645.  
  646.     NOTE the autosave file is created in the directory that IE is started
  647. from and will require the disk is not write-protected.
  648.  
  649.     NOTE also that the DEMONSTRATION version will automatically exit after an
  650. autosave.
  651.  
  652.  
  653.  
  654. PROJECT ICON HINT
  655. -----------------
  656.     If you have some icons that you use regularly then you can create a
  657. "library" of icons by saving them in a drawer as PROJECT icons.  Then by
  658. clicking on an icon, holding down the shift key and double-clicking on the
  659. IE icon you can start IE and IE will automatically load the icon.  You can
  660. then change the icon type, and other characteristics, and use the
  661. "PROJECT/SAVE AS" menu item to save the icon in the desired place and name.
  662.  
  663.     A better method than click, shift, double-click is to change the PROJECT
  664. icon's default tool string to be the full path and name of IE.  Then you
  665. just have to double-click on the desired icon and IE will start and
  666. automatically load the icon as above.
  667.  
  668.  
  669.  
  670. CONFIGURING IE - TOOLTYPES AND CLI PARAMETERS
  671. ---------------------------------------------
  672.     The various configuration settings for IE are controlled by:
  673.  
  674.     TOOLTYPES      - For Workbench users.
  675.     CLI PARAMETERS - For CLI users.
  676.  
  677.     To add tooltypes to the IE icon simply use IE.  Load the IE icon into IE,
  678. select the "ICON/EDIT INFO" menu item and add the tooltype into the tool
  679. types list.  Close the window and save the icon.  Restart IE to use the new
  680. tool types.
  681.     Another method is to select the icon in Workbench and select the "Icons
  682. Information" menu option.  Click on the "New" gadget, enter your tool type
  683. string and click on the "Save" gadget.
  684.     Note that the supplied icon with IE is 8 colours and IE will default to
  685. 4 colours.  If you wish to retain the 8 colours in the icon then it is
  686. advised that you use the "Information" menu option to add the tool type
  687. COLOURS=8 before editing the IE icon with IE.
  688.     Tool types must be entered each on a different line when adding them to
  689. an icon.
  690.     To add CLI PARAMETERS simply add the parameters anywhere on the CLI
  691. command to start IE.  The CLI parameter is the same as the tool type but with
  692. a "-" immediately before it.  This is to stop IE confusing parameters with
  693. icon names.  For example, "IE -INTERLACE" will start IE using an interlaced
  694. screen.
  695.  
  696.  
  697.     The tooltypes and CLI parameters are described below:
  698.  
  699.     TOOLTYPE      -    SUPERHIRES
  700.     CLI PARAMETER -    -SUPERHIRES
  701.         This starts IE using a SUPERHIRES screen resolution.  You need an ECS
  702.     equipped Amiga to use this resolution.  Non-AGA users can only have a
  703.     maximum of 4 colours while in this resolution.  AGA users can have 256.
  704.  
  705.     TOOLTYPE      -    INTERLACE
  706.     CLI PARAMETER -    -INTERLACE
  707.         This starts IE using an interlace screen resolution.
  708.  
  709.     TOOLTYPE      -    COLOURS=<n>
  710.     CLI PARAMETER -    -COLOURS=<n>
  711.         This selects the number of colours that will be in the icon.  Replace
  712.     <n> with the number of colours from 2, 4, 8, 16, 32, 64, 128 or 256.
  713.     For example, "IE -COLOURS=16" will start IE editing icons with 16
  714.     colours.
  715.  
  716.     TOOLTYPE      -    DBLHEIGHT
  717.     CLI PARAMETER -    -DBLHEIGHT
  718.         If you need to create an icon larger than 128 pixels high, this
  719.     parameter will start IE with a maximum height limit of 256 pixels.
  720.  
  721.     TOOLTYPE      -    DBLWIDTH
  722.     CLI PARAMETER -    -DBLWIDTH
  723.         If you need to create an icon larger than 320 pixels wide, this
  724.     parameter will start IE with a maximum width limit of 640 pixels.
  725.  
  726.  
  727.  
  728. A FINAL WORD FROM THE AUTHOR
  729. ----------------------------
  730.     I designed IE to be as simple to use as possible but still possess all
  731. the features required for the construction of icons.  The Amiga has a far
  732. better icon system than ANY of the other machines available and I hope you
  733. use IE to utilise the Amiga's icon system to it's fullest.  If I can be of
  734. any help in your usage of IE or icons then drop me a line.
  735.  
  736.     Thanks must go to all the people who have registered.  Without this
  737. support I would not have made this version.  Thanks also to those users who
  738. made suggestions for how to improve IE.
  739.  
  740.     Here is a count of registrations I have received to date:
  741.  
  742.     Country                         Number
  743.     --------------------------------------
  744.     Australia                         41 (To be expected, I guess)
  745.     Austria                            4
  746.     Canada                             1
  747.     France                             4
  748.     Germany                           36 (Hooray for Germany!!!)
  749.     Holland                            1
  750.     New Zealand                        3
  751.     Sweden                             2
  752.     Switzerland                        4
  753.     United Kingdom                     1
  754.     United States of America          13
  755.  
  756.  
  757.     A very special thanks must go to Leigh Murray of Queanbeyan, Australia
  758. for creating the IEv4.0 icons and beta testing IE for me.
  759.  
  760.     IE is being constantly updated.  If you can think of extra functions that
  761. might be of benefit in IE or some ways IE's interface can be enhanced then
  762. please contact me and I will seriously consider your suggestions.  The best
  763. thing about ShareWare programs are that YOU can make input to them which
  764. might make your life, and somebody elses, a little easier.
  765.  
  766.     If you like IE, or even hate it, please contact me as well as I like to
  767. hear what others think about my efforts.
  768.  
  769.     I hope that this program is of use to you and if you like it give the
  770. demonstration version to all of your friends.
  771.  
  772.     Best wishes and happy Iconing...
  773.       Peter Kiem.
  774.  
  775.